Repository navigation
docs: Prometheus /api/v1 paths, native image CPU baseline, bounded vector.fuse/rerank (#509, #501, #494, #498) - #510
Merged
Conversation
…line, bounded hybrid search - #509: every Prometheus-compatible endpoint is under /api/v1/ts/{database}/prom/... (timeseries concepts page, time-series tutorial, reference chapter, upgrade note) - #501: native image CPU requirements (x86-64-v3 / armv8.1-a), the startup error, how to check a host, and the workarounds (JVM image, -Dnative.march=compatibility) - #494: reference entries for vector.fuse (options incl. limit) and vector.rerank; a section on bounding the full-text leg and the fusion; bounded examples - #498: already covered by the Query Languages table (8f6e139) - _typos.toml: whitelist the identifier ANDed, which the hook rewrote to "ANDead" Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Contributor
|
This pull request does not currently match the merge queue conditions, so it cannot be queued from here. The box comes back if it matches again. |
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This was referenced Oct 28, 2026
Time series docs: every Prometheus endpoint path is missing the /api/v1 prefix (all return 404)
#509
Closed
Closed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #509, closes #501, closes #494, closes #498.
#509: Prometheus endpoints need the
/api/v1prefixThe Prometheus paths were documented as
/ts/{database}/prom/...and the server serves them under/api/v1/ts/..., so every one of them 404'd. Fixed inconcepts/timeseries.adoc(bothprometheus.ymlsnippets, the PromQL, labels and series examples, the endpoint table). The same mistake turned up in the time-series tutorial (twocurlcalls),reference/time-series/chapter.adoc, and anupgrade.adocnote that wrotePOST /ts/queryandGET /ts/latest. I checked the routes inHttpServer.java: the prom handlers are registered in the same/api/v1block as/ts/{database}/write.#501: minimum CPU for the native image
native-image.adocgets a "CPU Requirements" section. It lists the baselines (x86-64-v3,armv8.1-a), the features they need, and the CPUs and VM CPU models they rule out. It also quotes the startup error, explains how to check a host, and gives two ways out: the JVM image, or a build with-Dnative.march=compatibility. The build section now shows the--march/-Dnative.marchoverrides and warns against-march=native.install-docker.adoclinks to the new section. Source: the "CPU requirements" section of the engine'sdocs/native-image.md.#494: cost of
vector.fuse/vector.rerankNeither function had an entry in
reference/extended-functions/vector.adoc, so I added both. Thevector.fuseentry has the full options table, includinglimit, which was not documented anywhere. Both entries say what drives the cost and what changed in 26.11.1.concepts/vector-search.adochas a new subsection, "Bounding the cost of a full-text leg", with the bounded form:rerank(fuse(neighbors, SEARCH_INDEX subquery LIMIT :fetch, { limit: :candidates })). The existing three-way example and the two hybrid examples infull-text-index.adocnow putLIMIT 100on the full-text leg.I checked the text against
SQLFunctionVectorFuseandSQLFunctionVectorRerankat engine9d9aa076ab, and ran each query shape onarcadedata/arcadedb:26.11.1-SNAPSHOT(built 2026-10-26): the bounded nested query with parameters, a directSEARCH_INDEXsource withfusion: 'LINEAR',fusewithlimit, and the rerank example. The same run confirmed that aSEARCH_INDEXsubquery with noORDER BYreturns matches by descending$score, so aLIMITon it keeps the best ones.#498: Cypher and Gremlin on TIMESERIES types
Nothing left to do. The Query Languages table in
concepts/timeseries.adoc, added in 8f6e139, already lists SQL, PromQL, MongoDB QL and GraphQL as readers and says Cypher and Gremlin refuse a TimeSeries type. This PR just closes the issue.Also in this PR
The typos pre-commit hook rewrote
ANDedto "ANDead" in two existing lines offull-text-index.adocas soon as that file was staged._typos.tomlnow whitelistsANDedas an identifier.Checks
docs-validator.pyreports 3 broken refs, the same 3 asmain. Themigrate.sh+ Antora build adds no warnings for the touched pages, and the new cross-page links (#hybrid-search-bounded,#native-image-cpu-requirements) resolve.🤖 Generated with Claude Code